N4 supports EDIFACT standard COPRAR Discharge message, release D and version 95A
This COPRAR Discharge List message (COPRAR D 95A) permits the transfer of data from a line operator to a terminal operator.
The line operator will send the following details to a terminal operator:
Inbound vessel visit details
Container details
Equipment order details
Hazard and commodity details
This specification provides the definition of the COPRAR D 95A Inbound Discharge List message to be used in Electronic Data Interchange (EDI) between a line operator and a marine terminal, primarily to indicate which containers should be discharged from the vessel.
The following sections of this document explain how COPRAR D 95A Discharge message is handled in N4 and the scope of its implementation. This message is basically used for the following operations carried out by the terminal/line operators:
The line operator will send the inbound vessel visit details to a terminal operator.
The terminal operator will discharge the containers specified in the EDI message sent by a line operator.
COPRAR D 95A Inbound Supported Segments
The following table illustrates the segments of EDIFACT standard COPRAR D 95A message and the scope of each segment in N4.
|
S.No |
Group |
Segment ID |
Supported Qualifier |
Description |
Supported in N4? |
|---|---|---|---|---|---|
|
1 |
|
UNB |
|
Interchange Header (sender, receiver) |
Supported |
|
2 |
|
UNH |
|
Message Header (message type, message reference number) |
Supported |
|
3 |
|
BGM |
|
Beginning of message (message function) |
Supported |
|
4 |
|
FTX |
|
Free text |
Not Supported |
|
5 |
|
RFF |
|
Reference |
Not Supported |
|
6 |
SG1 |
TDT |
|
Details Of Transport (I/B vessel details) |
Supported |
|
7 |
|
RFF |
|
Reference |
Not Supported |
|
8 |
|
LOC |
11, 9 |
Place/Location Identification |
Supported |
|
9 |
|
DTM |
132, 133 |
Estimated Time Arrival/Departure of I/B vessel (132/133) |
Supported |
|
10 |
|
FTX |
|
Free text |
Not Supported |
|
11 |
SG2 |
NAD |
CA, CF |
Name And Address |
Supported |
|
12 |
|
CTA |
|
Contact Information |
Not Supported |
|
13 |
SG3 |
EQD |
CN |
Equipment Details |
Supported |
|
14 |
|
RFF |
BN, AAY, ABT |
Reference |
Supported |
|
15 |
|
EQN |
|
Number Of Units |
Not Supported |
|
16 |
|
TMD |
2, 3, 4, 5 |
Transport Movement Details |
Not Supported |
|
17 |
|
DTM |
|
Date/Time/Period |
Not Supported |
|
18 |
|
LOC |
7, 9, 11, 147 |
Place/Location Identification (delivery, destination, discharge) |
Supported |
|
19 |
|
MEA |
|
Measurement (gross weight), Tare Weight |
Supported |
|
20 |
|
DIM |
5, 6, 7, 8, 9 |
Dimensions (front, back, right, left, top) |
Supported |
|
21 |
|
TMP |
|
Temperature (preferred temperature) |
Supported |
|
22 |
|
RNG |
|
Range (Minimum, Maximum) |
Supported |
|
23 |
|
SEL |
CA, CU, QA, SH |
Seal Number (carrier, customs, quarantine, shipper) |
Supported |
|
24 |
|
FTX |
AAA |
Free Text (goods description, handling instructions |
Supported |
|
25 |
|
DGS |
|
Dangerous Goods |
Supported |
|
26 |
|
EQA |
CN, CH, RG |
Attached Equipment (payload unit, chassis, reefer generator) |
Supported |
|
27 |
SG4 |
TDT |
|
Details Of Transport (Outbound - truck/train/vessel details) |
Supported |
|
28 |
|
RFF |
|
Reference |
Not Supported |
|
29 |
|
LOC |
|
Place/Location Identification |
Not Supported |
|
30 |
|
DTM |
|
Date/Time/Period (Estimated Time Arrival of I/B Vessel Visit) |
Not Supported |
|
31 |
|
NAD |
|
Name And Address (Container Operator) |
Supported |
|
32 |
|
CNT |
|
Control Total |
Not Supported |
|
33 |
|
UNT |
|
Message Trailer |
Not Supported |
COPRAR D 95A Inbound N4 Built-in Map
N4 serves a built-in map for converting COPRAR EDI message into the Navis standard discharge list xml. This XML, in turn, is used for further processing.
Following are the related files that can be downloaded as part of N4:
coprar(discharge)_D_95A.mgt - GoXml map
coprar.dic - EDIFACT standard dictionary
dischlist.xsd - Navis standard xml schema
Special Cases
edi:ediOutboundVesselVisit
Added a filter (/EDI/Group_Loop/COPRAR/SG3/SG4/TDT/C220@A_8067=='1') such that it will be displayed only when the SG4 TDT has qualifer "1" (maritime transport)
edi:ediTrainVisit
Added a filter (/EDI/Group_Loop/COPRAR/SG3/SG4/TDT/C220@A_8067=='2') such that it will be displayed only when the SG4 TDT has qualifier "2" (rail transport)
edi:ediTruck
Added a filter (/EDI/Group_Loop/COPRAR/SG3/SG4/TDT/C220@A_8067=='3') such that it will be displayed only when the SG4 TDT has qualifier "3" (road transport)
COPRAR Inbound - Message Functions
As per EDIFACT standard, COPRAR has various message function codes in the BGM segment. N4 supports the following message functions:
BGM+661+WCP00000530901+3+AB' – Here, '3' is the message function qualifier.
|
Qualifier in the EDI message |
Value in the XML |
|---|---|
|
1 or 3 |
D - Delete |
|
Any Other Qualifier |
Default Behavior |
For information on the EDI message functions supported by COPRAR, see Supported EDI message functions (on page 1).
COPRAR D 95A Inbound Special Cases
Multi-facility scenario
If a given container in an EDI file is active in another facility, the system will create a new advised unit for the given facility.
N4 has a way of validating certain business conditions which might be applicable for some clients and might not be for some. Therefore, those validations are made configurable. That is, the user may turn it on if a certain validation is needed or turn it off, if not needed.
The following table lists such configurable settings applicable for the Discharge list EDI message:
|
Name |
Description |
Edit UI |
Usage |
|---|---|---|---|
|
ARGODISCHLIST001 |
List of Permissions to apply for Discharge List |
Session > Settings |
To apply all the selected permissions for the given containers in the COPRAR EDI message. |
|
ARGODISCHLIST002 |
Validate equipment type ISO |
Session > Settings |
Set it to true to validate the equipment type provided by the DISCHARGE List EDI message and generate an error if the equipment type is not found in the system. |
UNA:+.? '
UNB+UNOA:2+LAJPARTNER+131208+060227:1013+24'
UNH+2400001+COPRAR:D:95A:UN'
BGM+43+20060227101+9'
FTX+OSI++D'
RFF+XXX:1'
TDT+20+001+1++APL:172:20+++L1234:103::LAJIT VESSEL'
RFF+VON:029W'
LOC+11+NZLYT:139:6+:TER:ZZZ'
EQD+CN+BLKU1253160+2270:102:5++3+5'
RFF+BN:39430060'
LOC+9+SGSIN'
MEA+AAE+G+KGM:28000'
FTX+AAA+++LACTIC ACID FEED GRADE'
EQA+CN+PAY315398'
EQA+CN+PAY315399'
EQA+CH+CH315398'
EQA+RG+AC315398'
TDT+30++2+25'
NAD+CF+APL:160:20'
EQD+CN+MSAU1253160+2270:102:5++3+5'
RFF+BN:39430060'
LOC+9+SGSIN'
MEA+AAE+G+KGM:28000'
FTX+AAA+++LACTIC ACID FEED GRADE'
EQA+CN+MAY315398'
EQA+CN+MAY315399'
EQA+CH+CH315399'
EQA+RG+AC315399'
TDT+30++2+25'
NAD+CF+APL:160:20'
CNT+16:153'
UNT+944+2400001'
UNZ+1+24'
COPRAR D 95A Inbound Validations
Prerequisite to post a discharge list message:
Container ID, operator must be available.
Routing points must be in the itinerary.
Vessel visit must be present, else system will try to create a preliminary vessel visit, provided the auto-creation of vessel visit is enabled and the vessel details are given.
The line operator must be a shared line of the vessel visit if "SP_VALIDATE_LINE_PER_VSL" setting is enabled.
ISO code must be valid if "DISCH_VALIDATE_EQ_TYPE" is enabled.